home *** CD-ROM | disk | FTP | other *** search
/ Aminet 32 / Aminet 32 (1999)(Schatztruhe)[!][Aug 1999].iso / Aminet / disk / misc / ADFlib.lha / README < prev    next >
Text File  |  1999-05-24  |  3KB  |  115 lines
  1.  
  2.  
  3. The ADFlib is written to managed media formatted by the AmigaDos.
  4.  
  5. It is written in portable C, and support the WinNT platform to access
  6. real drives.
  7.  
  8.  
  9. Credits:
  10. --------
  11.  
  12. main design and code             Laurent Clevy
  13. WinNT native driver              Dan Sutherland
  14.  
  15.  
  16. New versions and contact e-mail can be found at : 
  17.  
  18. http://come.to/adflib
  19.  
  20.  
  21.  
  22. COMPILATION
  23. -----------
  24.  
  25. It had been tested on Intel/Linux with gcc 2.7.2, Solaris 2.6, and
  26. Win32.
  27. The size of long must be 4, the size of short 2.
  28. The library reads disk sectors written with the big endian (Motorola) byte
  29. ordering.
  30.  
  31. You have to type :
  32.  
  33. make clean
  34. make depend
  35. make lib
  36.  
  37. A 'lidadf.a' should be created.
  38.  
  39.  
  40. * Byte ordering
  41.  
  42. 'make clean' remove the temporary files and the 'defendian.h'. In this file,
  43. LITT_ENDIAN must be defined if the target machine uses the little endian 
  44. byte ordering, like this :
  45.  
  46. #ifndef LITT_ENDIAN
  47. #define LITT_ENDIAN 1
  48. #endif /* LITT_ENDIAN */
  49.  
  50. This should be done automatically by the 'myconf' shell script. myconf 
  51. autocompiles a C file which detects the byte ordering. The 'defendian.h'
  52. is generated in 'myconf'. 'defendian.h' should be included in every .c file
  53. which uses the LITT_ENDIAN define is used, otherwise the compiler could think
  54. it is not defined, and the target machine is (always) using the big endian
  55. byte ordering.
  56.  
  57. 'myconf' is launched by 'make depend'.
  58.  
  59.  
  60. * Native driver
  61.  
  62. The NATIV_DIR variable is used to choose the (only one) target platform
  63. of the native driver. The default is :
  64.  
  65. NATIV_DIR = ./Generic
  66.  
  67. This one do not give access to any real device. The other one available is
  68. Win32, to access real devices under WinNT.
  69.  
  70.  
  71. * Win32DLL
  72.  
  73. The 'prefix.h' is used to create the Win32 DLL version of the library.
  74. If the WIN32DLL variable is defined in the library code, public functions
  75. are preceded by the '__declspec(dllexport)' directive. If this same
  76. variable is defined, the '__declspec(dllimport)' is put before the functions
  77. prototypes in the 'adflib.h' library include file.
  78.  
  79.  
  80.  
  81.  
  82. FILES
  83. -----
  84.  
  85. README            The file you are reading
  86. TODO            Future improvements and bugfixes
  87. CHANGES            Detailed changes
  88. Lib/            main library files
  89. Lib/Win32/        WinNT native driver
  90. Lib/Generic/    native files templates
  91. Boot/            Bootblocks that might by used to put on floppy disks
  92. Docs/            The library developpers documentation 
  93. Faq/            The Amiga Filesystem explained
  94. Test/            Test files and examples (not perfect)
  95. Dumps/            .ADF used to test the library
  96. Refs/            text outputs of the test files
  97. Check/            files stored in the test dumps, used with 'diff'
  98. Bonus/            Additional useful .ADF dumps
  99. Demo/           unadf.c
  100.  
  101.  
  102. Possible bugs
  103. -------------
  104.  
  105. - in dircache updates
  106. - when a volume is becoming full
  107. - lost memory releases
  108.  
  109.  
  110. Please report any bugs or mistakes in the documentation !
  111.  
  112.  
  113.  
  114. Have fun anyway !
  115.